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toward the front door and there, in its shadows, youll find Open-Apples tiny 
booth, #222. Stop by and meet the family. Bring money. Open-Apple will be 
having its first-ever sale on books, back issue volumes, and maybe even 



Let's make one thing clear 

Apple has named its new software company Claris Corp, according to a 
mid-JulyAppIe press release. The name is to reflect "clarify and distinctiveness, 
and to remind us that shaping the future requires a ciea r vision," said William 
V Campbell, president of the newventure. As predicted in last month's Open- 
Apple (page 3.41), the new company's name was derived from a foreign 
tongue — Claris comes from the Latin ward for clarity. (OK, OK, so I said it was 
going to be Sanskrit — it was a better guess than anyth ing you saw in FUbble, 
wasn't it?) Claris expects to move into new headquarters in Mountain View, 

California by October. — rietectdifferences that the eye might miss, particularly when the person is 

(While most of you seem to have no trouble separating Open Apple s . tiredothared while poring over data, 
baloney from its technical accuracy. It has become clear in the last few weeks 
that 1 should warn the grim-faced few among you that I do occasionally 
attempt to spice Open-Apple up with a little humor, and that such attempts 
often involve exaggerations and outright lies. The lies are supposed to be 
preposterousenoughlhat you recognize them as whimsy. Lest some gullible 
private eye should waste days looking for the "sources close to the company, 
who asked not to be identified," who tipped Open-Apple off to Claris' foreign 
name, let me assure you that such sources do not exist 1 just got lucky. 
Likewise, some of you seem to believe (or at least think / believe) that Open- 
Apple really had something to do with Apple's decision to start this new 

quite sure Open-Apple had nothing to do with the decision. 1 have no 
evidence that any of the high-level executives at Apple so much as read this 
newsletter, much less take It seriously (although there is a copy of Steve 
Wozniak's three-year subscription payment hanging on the wall around here 
somewhere). I figure Open-Apple has the presence and influence of a pesky 
house fly at Apple Inc, but no more. I tell you this so that you have a less dim 
idea of what herein, is supposed to be preposterous, and therefore 
humorous. If, gentle readers, you don't stop taking my soliloquies so 
seriously, I'm going to change the name of this newsletter to Open-Addle. ) 

They answer the phone "Beagle Bros/Software Touch" at the Beagle 
Bros number these days. Bert and Sharon Kersey, the husband-wife team 
who founded Beagle Bros, have sold it to Mark Simonsen. Simonsen, along 
with Alan Bird, was a founder of the Software Touch. The two companies are 
being combined and a bevy of new AppleWorks enhancement programs, to 
be called the Time Out Series, is being readied for a September introduction. 

Simonsen and Bird were Beagle Bros programmers before they started the 
Software Touch. Kersey remains as a consultant to the company. He says he's 
still interested in computers and the Apple II but is tired of running a 



Remember the one about the chemists who changed graphs into 
sound? (See ' Drumming insight out of data," March 1986, page 2.9 and 
"Apple Assembly Line" September 1986, page 2.58.) Mow biochemists at 
Michigan State have developed a musical way to read the graphs turned out 
by an automated analyzer, according to the June 17 Ifail Street JoumaL 

"The ear is fantastically discriminating' in detecting differences in notes 
and changes in tempos, explains biochemist John F. Holland. The ear can 



"Profs. Holland and Charles C. Sweeley adopted the idea for their research 
and began telling others. The Erst response was usually humorous; people 
would ask us what this week's top 20 urines were,' Prof. Holland says. But now 
researchers have begun adopting the idea for graphs turned out by blood 
analyzers used in clinical laboratories and electrocardiograms. 

"The biochemists have called in two music professors to help convert 
graphs that depict normal results to recognizable tunes. 'A normal urine, for 
Instance, might play "America the Beautiful," which is a tune everybody 
carries around in their head; Prof. Holland explains. If the machine suddenly 
sounded a sour note, the technician would immediately know an abnormal 
urine had just been analyzed," 

There are some amazing discoveries yet to be made in this area and the 
Apple llgs is the perfect research ship to make them in. 



Youll be able to shake Kersey's hand, as well as those of other 
infamous Apple II scoundrels, at the upcoming AppleFest in San 
Francisco. The dates are Friday, September 18 through Sunday, September 
20. The place is the Civic Auditorium, On Friday and Saturday the show's 
exhibits will be open from 10 to 5, on Sunday from 10 to 4. Conferences will 
also be held all three days. Conference keynote speakers are Steve Woznlak 
and Del Yocam, Apple's Chief Operating Officer. Entrance to the exhibits for 
all three days is $15, exhibits plus the full conference will be $50. American 
Airlines is supposedly offering special fares for attendees, call 1-300-433- 
1790 and ask for Star File #513312. 

You'll occasionally find Kersey at the Beagle Bros/Software Touch exhibit 
Go in the front door of the auditorium, walk down the left side of Apple's 
exhibit and continue walking toward the back of the auditorium. You can't 
miss it It's the big booth in the back. Walk all the way around it and head back 




"I WS TOLD THIS IS WHERE THE 
APPLE USERS GROUP MEETS." 
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The other DOS 3.3 

I enjoyed your little article on trademarks that 
appeared in the July 1987 issue of Open-Apple. 

1 found it particularly entertaining in light of some- 
thing that recently happened to me. I saw an article in 
a magazine (that shall remain nameless! and promi- 
nent in the title was the name "DOS 3.3". Hey, 1 said to 
myself, I know something about that this may be 
interesting. I started reading the article and it didn't 
take long to realize that something was very wrong. It 
seems that the latest version of MS-DOS is— you 
guessed it— 3.3. So now when you see the term DOS 
3.3 it is not going to be the DOS that we all know and 
sometimes love, hut some hideous impostor. There 
ought to be a law. 

Jesse D. Sheinwald 
Seafbrd, N.Y. 

The same thing happened to me. It reminds 
Dennis and me of when the Hitlers appropriated the 
widely-used term "PC" and converted it from initiate 
that meant any persona! computer into initials that 
meant one specific (and now defunct, as far as IBM is 
concerned) computer. 

How about a boycott? 

I would like to bring to your attention another case 
in which legitimate use of a software product by the 
owner is interfered with by short-sighted copy- 
protection policies. The company in this case is 
Electronic Arts, and the specific product is Deluxe 
Paint //for the Apple llgs. 

After seeing a mone-than-impressive demo at my 
local Apple dealer's and immediately deciding on a 
purchase, I was deeply disappointed to discover that 
tile program out of the box would not boot on my llgs, 
apparently because of Its copy-protection scheme, 
The protected program refuses to recognize the 
supplied "key disk" in my Mikon 3,5 inch drive, 
connected to a Central Point UDC card in Slot 7. 
Technical support personnel at Electronic Arts were 
courteous but not helpful— the company's position 
is that they do not guarantee their software to run on 
any configuration except pure off-the-shelf Apple 
hardware land they admitted that even owners of the 
Apple UniDisk 3.5 had reported problems). Their 
suggestion was that f send in a coupon enclosed in 
the package, along with $20, and wait two weeks (the 
coupon says 4-6 weeks) rbrdelivery of an unprotected 
version, which they feel will run on any configuration. 

As a long-time Apple owner and as purchaser over 
the years of scores of software items, the ownership of 
none of which I have abused, I feel insulted by 
Electronic Arts' presumption, riot only does their 
policy penalize users who, like me, believe that third- 
party vendors have a legitimate and important role to 



play In the marketplace, but they seem to overlook 
the fact that much of the appeal of the Ugs is that a 
purchaser (in theory) doesn't have to buy everything 
all over again, but should be able to bring along all his 
favorite peripherals. There is also the question of 
whether the large number of He owners who can be 
expected to upgrade their systems in the next year or 
so will be able to run Electronic Arts software without 
encountering annoyances similar to mine. 

I have gone along (under protest) with Electronic 
Arts' suggestion, but only because i have determined 
Deluxe Paint tl to be a "must have" item, it is the 
fortunate company that can manage to publish only 
items in this category, and when in the future I am 
faced with making or recommending a choice between 
purchase of comparable products I will surely favor 
those companies (in my experience the majority) who 
trust and support their customers. 

R.W.W. Taylor 
Rochester, JiY. 

The only point at which you and I differ is your 
opinion that Deluxe Paint His a "must have" item. 
Copy protection is stupid, tt not only harms customers, 
in the long run in harms products and publishers. It's 
a bad marketing strategy, to say nothing of being 
bad in every other way. 

With the Ugs in particular I advise you to simply 
stay away from copy-protected software. It's dan- 
gerous stuff. It can mess up your system and mess 
up your disks. You can't put it on mass storage 
deuices such as RAMdisks, ROMdisks, or hard disks. 
You can't use a program selector with most of it. As 
you've experienced, it often doesn't work if the 
harduiare isn't just right. (Acttvislon's llgs protection 
scheme fails if you have a 5.25 floppy controller or a 
mouse card plugged into your system— whether 
the card is turned on or not.) Copy-protected software 
often doesn't work on later, more aduanced compu- 
ters. And all of this is nothing compared to the 
problem you have when your copy protected disk 
goes bad. With rare exceptions, we simply don't talk 
about copy protected software in Open-Apple. 

There is a wealth of non-copy-protected software 
in the Apple II kingdom. You don 't need to mess with 
the copy-protected stuff. Look to companies who 
don't use copy-protection for your software needs. 
For example, there's Apple itself, Beagle Bros/Software 
Touch, Pinpoint, Penguin, Central Point, WordPerfect, 
Sorcim, Diversified Software Research, Stone Edge, 
Data Transforms, and many, many others. These 
compan ies may not have a Deluxe Paint B available 
at the moment, but they will. Patience. Support them 
when they do. Each dollar you spend on copy- 
protected software now is a vote for more copy- 
protection in the future. 

1 admit it's hard to make an informed vote when 
none of the publishers who use copy-protection will 
admit it on the outside of their package, or even, 
usually, in their documentation. You just have to 
(earn which companies use protection and refuse to 
buy anything from them. Three major companies to 
avoid are Electronic Arts, Actfcision, andB roderiu nd. 
These three could fall off the edge of the earth and we 
wouldn't even notice It around here. 

Integer Basic manuals 

Although Integer Basic has been shied away from 
over the years, there were definitely some decent 
routines in place of the floating point routines of 
Applesoft Integer Basic includes sound routines, 
renumbering routines, and a Mini-assembler. There 



are several undocumented routines that I'd like to 
learn about including the SWEET- 16 pseudo-processor. 
However, I cannot seem to get my hands on any 
Integer Basic documentation. It's all Applesoft. 
Addlson-Wesley (the manufacturer of most Apple 
books) does not have any Integer Basic tutorials. I 
was wondering if anyone out there knew of any old 
Integer Basic manuals I could get my hands on. The 
Woz left some great stiff in there.. 

Christopher Harrison 
2516 Hiltwood Place 
Charlottesville, VA 22901 

The Computer Shopper ($21/yr, P.O. BoxF, Titusville, 
FL 327811 sometimes has advertisers offering old 
Apple manuals for sale (look in the classifieds under 
the Apple section). Apple's Integer Basic manual was 
titled Apple II BASIC Programming Manual How- 
ever, it is really only a tutorial. To my Knowledge no 
one ever wrote the equivalent of an "Integer Basic 
Technical Reference Manual." 

There are a few other additional references we 
know of that you may be able to find in a library or 
borrow from a fellow user-group member, fii-rts 
graphics, sound, renumbering, and several other 
assembly language utilities for use with Integer 
Basic were made available by means of a ROM chip 
called the Programmer's Aid #L The chip fit into an 
empty socket in the original Apple U and appeared in 
memory at $D0OO-$D7FF. The chip's information is 
included in the Integer Bask image that's on DOS 3.3 
master disks. The book associated with this chip was 
called Programmer's Aid #1 Installation and 
Operating Manual 

The Mini assembler has been discussed right here 
in Open-Apple (March 1985, page 120; May 1387, 
pages 3.27-3.28). More extensive documentation is 
auailaile In any of Apple's Apple 11 technical reference 
manuals. 

Wbzniak's SWEET-16 interpreter was well docu- 
mented by its author in "SWEET-16: the 6502 Dream 
Machine" in the Tiovember 1977 issue of Byte 
magazine, pages 150-159. SWEET- 16 code takes up 
about half the space of 6502 code, but runs about ten 
times slower. The S-C Macro Assembier includes the 
ability to assemble SWEET-16 and its manual includes 
a iis( of opcodes and some programming examples. 
Another article is "SWEET-16 Revisited," by Charles F. 
Taylor, in Micro -the 6502/6809 Journal, January 
1982, pages 25-42. 

There is also a set of floating point routines In the 
Integer Basic ROM. These were described in "Apple's 
Hidden floating Point Routines" in Kilobaud Micro- 
computing, February 1980, pages 132-135; in Peek- 
ing at Call •A.P.P.L.E, Vol 1; and in some materials 
that were once available from Call -AP.P.LE. called 
the'WoipalC 

6502 forever 

Would learning 6502 machine code be worth the 
time and effort? In the years to come the 6502 will 
probably sink deeper into the well of history. Could 1 
expect to gain insight that would cany over to other 
systems by learning the 6502 now? 

BrettPuIl 
Colorado Springs, Colo. 

Sure. One of the neat things about the 6502 is that 
everything you team can be used with the newer 
chips in the same family, such as the 65816 used in 
the Apple llgs. A 52-blt chip is also planned for this 
family, sowhatyou team should serve you for many 
years. Lots of what you learn, but not everything. 
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will also apply if you later switch to a different family 
of microprocessors. 

To team 6502 assembly language you need to get 
an assembler and some good books. We published a 
rundown on the major assemblers in August 1986, 
page 2.55. Books that cover the present 6502 family 
are listed on page 2.56. Our favorite introduction to 
6502 programming is still Assembly Lines, by 
Roger Hagner— available for a mere $2.95 from 
Polarware, P.O. Box 511 Geneva, IL 60134 312-232- 
1984. We're also interested in hearing of other 
reader's favorite introductory texts to assembly 
language. 

COP that ROM desktop, MDIdeas 

Does anyone know anything about MDIdeas, Inc.? 
Are they reliable? Is the OctoRAM board by them any 
good? Is it better than the llgs KAMPIus by Applied 
Engineering? 

In the Apple Hgs Technical Reference by Osborne/ 
McGraw-Hill (a very good book) there is listed an 
opcode for the 65816 called COP. This stands for 
coprocessor latch. This sounds awfully like "go use 
the math coprocessor." If so, why haven't I read about 
it here? And why hasn't Apple said anything about it? 

Wouldn't it be nice to turn on your llgs, watch the 
desktop pop up, click an AppleWorks icon and be 
ready to go in under 5 seconds? Currently, it takes 
more than a few minutes. Well, you can with ROM 
cards! Be on the lookout! These cards could be the 
hottest things to hit the llgs market 

Uncle DOS, I've seen your complaints about the 
Apple Desktop and the push Apple is giving that type 
of interface. I do believe Apple should support the 
AppleWorks-type file Card Interface, since its easy, 
portable, quick, and suits the Apple well. However, the 
mouse interface also works very well, and on the llgs 
it should be exploited. The interface makes it easy to 
leam new programs, it allows for more graphically 
oriented work, and makes programs semi-portable 
from Mac to llgs. 

Sure ifs not perfect and can be awkward in some 
programs, but the file card interface can't solve every 
problem either. The mouse interface also has a 
standard disk access protocol that makes disk usage 
much easier. There are programs out that also make 
ProDOS easier to use in text mode but they vary in 
quality and execution. The mouse interface allows 
beginners to jump right into the file storage area and 
not get lost by protocol or command names. For 
ordinary Joe Schmoes that aren't computer literate 
but need to use a computer, the mouse interface 
makes it much easier. Doug McCIure 

Carmel, Ind. 

We had never heard of MDIdeas before the llgs 
came out, when they were suddenly right there with 
a basketful of cards for the new machine. So I called 
them up and asked them some questions. 

The company is about two years old. It got its start 
selling hard disk drives for the Macintosh One of its 
primary assets seems to be a strong relationship 
with Apple's euangetisis, which put it in a good 
position to develop add-on cards for the Ugs. 

Their Octof!am card is different from the other Hgs 
memory cards on the market in that is uses a 
memory chip called a SIM. A 256K SIM actually has 
256ft bytes of memory, unlike a normal 256K 
memory chip, which has only 256r\bits (you need 
eight of them, mother words, to actually add256Kof 
memory to your machine). Their card has sockets for 
eight SIMS, which are available in a 256K version fo r 



about $ 75 and inal megabyte uersion for about 
$400. Thus, someone with deep pockets could 
expand this card to a full 8 megabytes. MDIdeas sells 
its Lmegabyte card, which uses four 256K SIMS, for 
$349.95. As chip prices fall, you could reasonably 
add more memory to this card until it . was fully 
loaded. SIMS are also used on the Macintosh. 

There's a $179.95 add-on for the OctoRam called 
ESP that puts up to 512K of battery backed-up RAM 
into the address space the llgs uses as a ROMdisk. 
That's interesting, since the big problem I see with a 
ROM disk is updating the programs you put on it 
MDIdeas also has a llgs stereo card ($59.95), a llgs 
sound input card ($59.95), and a llgs fan/surge 
suppressor ($149.95). The company's address is 
1165 Triton Drive, Foster City, CA 94404 415-573- 
0580. 

We mentioned the COP instruction in our big 
August 1986 issue on the 65816 microprocessor 
(page 2.53, 2.55). It is indeed a command for 
passing control to a coprocessor. The reason you 
haven't heard more about it is that there isn't yet a 
coprocessor for it to pass control to. A similar 
instruction is WDM, which is reserved for accessing 
52-bit instructions in the 65852 microprocessor —a 
member of the venerable 6502 family that is also still 
under development 

/agree that ROMcards are going to provideuswith 
Interesting possibilities, but if speed is your thing fas 
it is mine), why not use ProSel instead of the llgs 
Launcher or Desktop ? I have a He here (that we leave 
on all the time) that has most of the programs I use in 
an Apple Memory Expansion Card. It can get to the 
ProSel menu from an open-apple/control/reset boot 
in less than three seconds. From ProSel to the main 
AppleHorfcs menu also takes less than three seconds 
with Alan Bird's "Don't Pass Go" patches. Just as 
important, to get back to ProSel after quitting Apple- 
Works takes less than a second. This kind of speed is 
what Hook for in a computer system. 

In general, however, I agree with your comments 
about the mouse interface. Its great for beginners 
and great for graphics-oriented programs. However, 
it is stow compared to the file card- or magic menu- 
type Interface— particularly when switching from 
one program to another. It is also highly dependent 
on a mechanical device, the mouse, thatlhave found 
to be unreliable. (When was the last time you pushed 
one of your cursor keys and the cursor didn't move? 
When was the last time you had to clean your cursor 
keys? Both situations are common mouse problems 
around here.) 

Nonetheless, those of you who think I am against 
the mouse interface have misunderstood me. What I 
have been against is the total abandonment of the 
file card interface in favor of the mouse interface, 
something Apple's people were pushing hard for 
some time ago (their zeal cooled after they were 
unable to add a mouse interface to AppleWorks). I 
think both types of interface have an important place 
in the Apple II kingdom. 

Cheap accounting 

What do you know about DASH Accounting's 
Accounts Payable program for the Apple lie. It adver- 
tises so much for so little. 

Terrance A. Dunbar 
Schnecksville, Pa. 

We called DASH at 408-356-3616 and found out 
they have just finished a non-copy-protectedProDOS- 
based accounting package that goes for $149. The 
$99 product they have been advertising is DOS 3.5- 



based. Another possibility is a $69.95 package 
($77,45 uilth shipping), also not copy-protected and 
ProDOS-based, called DAC Easy Accounting (214- 
458-0038). We haven't seen either package, but our 
interest is high. Well try to do a comparison in an 
upcoming issue, Well also try to include Manzanita's 
Business Works. If any of you know of any other 
non-copy protected, ProDOS-based accounting pack- 
ages worth looking at, please let us know. 

Applesoft enhancements 

For those interested in entering formulas for Apple- 
soft translation ("Interactive formulas", March 1986, 
page 216), there is an "evaluate string toolbox'' 
routine included with the TERC Basic Enhancements 
Version 6.0 from Technical Education Research 
Centers, Inc. This is a nice package; it contains a 
bunch of ampersand-like routines that use the ' 
instead of the Sr. The routines allow labelled subrou- 
tines, formatted printing, better input and many 
programming aids. 

JohnM.Wargo 
Akron, Ohio 

77ie TERC paclcage is fully described by one of its 
authors in the June 1387 Call -A.F.F.LE., pages 19- 
21 APPLE. Co-op members can get a shareware 
Version of the program from the co-op for $4. The 
package is also available, with a printed manual, for 
$15 from Sean Nolan, 68 Roseland St, Sommerville 
MA02143. 

80-column windows 

How can I set an unmovable "frame" on the 80- 
column screen? POKE <top> and (bottom) still work, 
but (left) and <right> don't 

John Jessmer,Jr. 
Brooklyn Park, Minn. 

See "The wonderful world o f windows" in our June 
1985 issue, page 48, for everything we know about 
putting window frames on the Apple II text screen. 
Here are the essentials. 

When using 80-column mode on the unenhahced 
He, the left and right edges of your window must be 
in odd columns (assuming you call the first cotumn 
1 not 0), and POKE 1403,X-1 does what HTAB X is 
supposed to do but doesn't. j4/ujays place the cursor 
inside the current window after you POKE in the 
edge ualues. 

After doing a PRIM CHR$(4); "FR#3" to turn on 80- 
columns, do another PRIifT before doing anything 
else. All the PR#3 does is redirect output to the 80- 
column firmware— the 80-column screen doesn't 
actually get turned on until something is printed. 
Any POfiEs (or VTABs or other formatting) you do will 
be lost when the 80-column screen is initialized. Play 
with this little demo if you think PR#3 can turn on 80- 
columns ail by itself: 

10 PRINT CHRI(21) : REM turn Off OB-columns 
20 PRINT CHR$(1);"PRtl3" 
38 GET HS 

If these hints and the June 1985 article don't solve 
the mystery (and maybe even if they do), you might 
want to consider incorporating one of the several 
commercially available windowing routines into 
your program. For example, Roger Wagner Publish- 
ing's Trial Site Toolbar (free to Open-Apple sub- 
scribers from Roger Wagner Publishing, P.O. Box 
582, Santee, CA 92071) conlains a windowing routine 
accessed with ampersand commands. Mite Owl 
Software (5734 Lamar, Mission, KS 66202, 913/362- 
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9898) has a $39.95 ProDOS-based set of utilities 
titled Developer Disk #2 that includes a windowing 
utility among Its many programs. 

Boot stop, hi-res switches 

Is there a POKE or CALL that will prevent a control/ 
open-apple/reset le-boot on the lie (POKEs. CALLs, 
etc)? Is there any specific call that will display hi-res 
page 2 without erasing it? 

T.Gotanda 
San Diego, Calif. 

Mb and yes. Contro(/open-appte/resettsanarditiare 
/unction that cannot be modified with software. 

)ou can turn on hi-res page 2 without erasing it by 
flipping the sofiswltches that control what your 
Apple is displaying on thescreen. For an introduction 
(o the concept ofsofiswitches see 'The Magic of ft ek 
and Poke'' in the February 1986 Open-Apple, pages 
2.2-5. 

There are four pairs of video-display softswitches 
thai have been around since the orfgirtat Apple IS. 
One pair determines whether the screen wStshow' 
"page 1" or "page 2." Another determines whether 
the screen wilt show text or graphics. A third selects 
between hi res and low-res; the fourth between full- 
screen graphics and mured graphics with four lines 
of text at die bottom of the screen. Mere are the 
locations of these switches. You throw them by 
POtiEing them (It doesn't matter what valve you 
poke, but zero is nice plump Utile number). 





-decimal 


hex 


description 


49232 


- 16384 


3.C050 


display graphics 


4=233 


•16303 


ICH51 


display taxt 


49234 


-16302 


IC9SZ 


full screen graphics 


49235 


-16301 


*C053 


mix graphics and text 


49236 


-16300 


W054 


page 1 


452:-" 


-16299 


IC055 


page 2 


4=:;3 


-1E29B 


:lh"£ 


lou-res 


49::; 


-1K297 


»C957 


hi-res 



For example, the following lines in an Applesoft 
program will switch from a display of the text screen 
to a display of hi-res page 2: 

118 POKE 49234, a ; HEM Full screen 

120 POKE 49239,8 : REM hl-res 

130 POKE 49232,8 : REM graphics 

140 POKE 49237,0 : REM pegs 2 

RAMdisk detective 

I'm writing a program that should use a ProDOS 
RAMdisk. Is there any way to tell from within my 
program if a supplied pathname is actually a RAM 
disk and not a regular floppy? c^ris Strauser 
nacogdoches, Texas 

you can detect rMMdisfcs that use the SmartFort 
interface as shot™ here in January 1987, page 2.92. 

rion-Smartport RAMdisks are more difficult to 
detect The volume name of most RAM disks begins 
with /RAM. That's probably the best way but it's not 
perfect CfiedcAfate's large ProDOS uoiume is named 
/MRAM, and there is an outside chance that some 
enterprising user may rename the RAM volume. 

Another possibility is to show the user the names 
of the votumes that are online and let the user select 
which one will be used for program operations. The 
user's seiection could be saved and used by default 
fmm then onward. If the volume was missing at 
startup, or if the user chose to reconfigure the 
program, you could ask the question again. This has 



the advantage of allowing the user to select other 
types of devices than RAMdisks for program opera- 
tions. It would also be a good idea to let the user 
specify how much of the RAMdisk your program 
may use. 

Good BYE, /RAM bug 

I have a very long ProDOS 8 SYSTEM file tha 1 1 can't 
execute from Applesoft because it overwrites 
Basicsystem. 1 have a little Applesoft program that 1 
want to run right before this SYSTEM file to set up my 
RAMdisti. Any ideas? 

One more point of mystery to me. One of my 
Applesoft programs tries to determine if the data files 
it needs are online by OFEPiing a directory (",TDIR") 
and READIng it My routine knows it has reached the 
end of the directory when it sees the "BLOCKS FREE 
..."bannerattheendofthedirectory. / 

This works until the program searches the /RAM 
volume. If I have previously run Applied Engineering's 
ProDriw to create a RAMdisk, everything is fine. But if 
there is only the small 64K ProDOS RAMdisK. the 
program bombs with an^iEfOr DATA error. The 
small /RAM wifriwtreturn the "BLOCKS FREE..." 
message when you READ It though obviously it does 
if you use CATALOO. 

Mystery? Then it got worse! 1 found the same thing 
occurs if I run the search on the AppleWorks program 
disk - a disk with only 2 free sectors. What's up here? 

S.WCummings 
Clearwater, Fla. 

7b start your large SYSTEM program you need a 
small assembly language program that will load and 
execute It.usmg ProDOS Machine Language Interface 
commands. If you want to see how that's done, 
check out the sample program in Gary tittle's 
Apple's ProDOS: Advanced Features for Pro- 
grammers, pages 107-112. 

A simpler possibility is to use the "auto-run" 
protocot supported by many SYSTEM programs. For 
example, ProSel supports this profocoL Just as 
Basicsystem will run a program called STARTUP 
when it Is executed, ProSel will run a program of 
your choice when it is executed. (When you use this 
feature, ProSel will install itself in the ProDOS QUIT 
command area then run the program of your choice 
rather than going to the ProSel menu.) 

The protocol works like Otis. The first three bytes 
of the SYSTEM program must contain a JMP to the 
program's actual starting location. The fourth and 
fifth bytes ($2003-4) must both contain $EE (238). 
The next byte contains the length of the buffer that 
follows, the next the length of the name of the file 
you want to auto-run. The bytes after that contain 
the actual name, for more complete information, 
see Little's book, page 141 or the ProDOS Technical 
Reference Manual, pages 86-88. 

In your case, you can simply BLOAD ProSel (use 
PROSF.LSY5TEM for AS in the following program), 
poke the name length and name of the SYSTEM 
program you want to run into position, and CALL 
ProSel. Here's how: 

100 BEPl »*« Cheap Launch *** 

110 F5="progrsn you want to execute" 

112 fiS=*prograri that supports suto.run protocol"" 

120 PRINT CHRI|4}j-BL[H1-;«j \RIZ000,I5¥S" 

130 5=9132 : REM »20»0 

132 IF PEEK(5] <> 76 THEN 489 

134 IF PEEK (3+3) < > 238 THEN 499 " 

136 IF PEEK [5+4) < > 238 THEN 498 

138 IF PEEK [5+5] < LEN|Ft)tl THEN m 



140 POKE S+6, LEN(FS) 

158 FOR 1=1 ID LEN(FI) 

160 : POKE S+E+l. P.SC{MI0I(FJ,I,1)] 

170 NEXT 

Z00 PR1NI CHW(4); "CLOSE" : REN close all Files 

218 FOR 1=4B9B4 TO 49006 : POKE 1,8 : NEXT 

22B POKE 49997,1: REN clear bitnap 

300 .".= _ S : REM launch from ProSel 

490 PRINT "ERROR- -THIS SYSTEM PROGRfiH" 
401 PRINT " DOES NOT SUPPORT AUTO-fiUN* 

On to the problems you encountered with the 
ProDOS 64K /RAMdisk. The problem with reading 
the /RAM directory stems from a design decision. 
Every main ProDOS volume directory is supposed to 
contain four blocks of information; no more, no less 
(this is mhaf limits a ProDOS main directory to a 
maximum of 51 filenames). But /RAM, mind you, has 
only a one-Node main directory. It holds a maximum 
of 12 filenames. This gives /RAM three extra blocks in 
which to store files, but trips up Basicsystem, which 
expects /RAM to follow the normal protocol 

The same problem is responsible with the Apple- 
Works program disk-due to the size of the pies, the 
program disk's directory had to be reduced to 
squeeze all the files onto the 5.25 inch disk. 

The default mapping of the first few blocks of /RAM 
for ProDOS appears to be 

block e+ctk, clock (normally boot code] 

block 1 empty 

block 2 uoluffle directory 

block 3 volure ^:t-ap 

blDCk 4-7 unj&atie 

Blocks 0-7 are marked as "used" within the /RAM 
volume bitmap. Even attempting to write directly to 
blocks 4-7 with a disk editor leaves the Modes 
unchanged. Therefore, blocks 0-1 and 4-7 are assumed 
to be unusable for data. This is logical since areas of 
the Apple's alternate 64K must be resewed for other 
uses (alternate memory zero page and stack from 
$OO0O-$0100, Bthwlumn text display page IX at 
$O4OO-$07FF). 

The problem could be corrected by "stretching" 
the /RAM volume directory back to the normal four 
block length. But that cure is pretty complicated. 
How that you know what the problem is, you'd be 
better off Just trapping the £TYD OF DATA with an 
OftEffl QOTO statement and letting your program 
be. 

This doesn't work for some people, however, 
because what they actually want to know is how 
much free space is left on the disk, rather than what 
files are in the main directory. In this case, the best 
work around is to create an empty subdirectory 
(PRimD$rCREATEFREESPACE.DIR, TDIR"), READ it, 
then DELETE it Since even /RAM subdirectories 
adhere to alt ProDOS specifications, you'll be able to 
READ the whole thing. It s possible that the CREATE 
command will return a DISH FULL error, however. In 
that case the error itself tells you what you wanted to 
know—how much room is left on the disk (none). 

Incidentally, nibble published an article also 
referring to this problem ("/RAM FIX", rtou 1986, 
page 124). The p rogram given to correct /RAM seems 
to haue some problems that can be demonstrated by 
running the following test after using nibble's 
program: 

10 HEM «« Fill /BfiM ulth dummy files *** 
20 W 

-30 PRINT CHRS[4]:"SnVE /RAM/F1LE.N0.";I 
35 PRINT "FILE. NO. ";I 
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48 1=1+1 
50 HTO 36 

The fix /ails due to an initialization error in the 
repairprogram. 

Patch marker 

I have so many disks with the PKODOS file on them 
that it is hard to remember which ones have had your 
"Stop track trashing" patch applied and which 
haven't (November 1986, pages 2.73-74). I added the 
following tine to your patch program. 

350 POKE 9463, ?0B 

It appends the letter T' to the title "PRODOS 111" 
that appears during startup. This F tells me that that 
version has had the bugs eradicated. 

Rick Highness 
Vacaville, Calif. 

BLOAD NOT.ALLOWED,A$400 

Why can't / BSAVE/BLOAD text page 1 when using 
FroDOS? The command (A$400, L$3FF) prints a HO 
BUFFERS AVAILABLE message. 

Dudley Glass 
Vienna, Va. 

Under DOS 3.3, programmers developed the bad 
habit ofBMmng text screens and BLOADIng them 
later. Unfortunately, this practice isn't safe because 
of the invisible "screen holes" that, are embedded in 
the text page memory area. These screen holes are 
used by devices in slots and by the system firm ware 
to remember such things as the last disk track 
accessed, the current horizontal cursor position, the 
serial card baud and data format settings, the active 
$C800 ROM bank, and much more. Although the 
worst effect in most cases is a "grind" of the disk 
drive after each new screen is BLOADed, there is 
potential for more serious ramifications. Thus, ProDOS 
protects die sereenholes by marking text page 1 
($40Q-$7FF) as protected in its system bit map. 
Trying to BLOAD a file into a protected area never 
succeeds, It always causes Basicsystem to return 
the totally inaccurate (In this case) HO BUFFERS 
AVAILABLE message. 



Flicker comparisons 



I've been going blind using MfordStar with my Apple 
He and Apple Hi monitor. Can you recommend a 
monitor (monochrome), presumably with a long 
persistence phosphor, to reduce flicker and any 
added plug-in boards to improve resolution and 
reduce flicker? Why are the IBMs or Compaqs so 
much better in this regard? 

Phillip Cutler 
Costa Mesa, Calif. 

That's not normal. In fact the Apple III Monitor 
already has long-persistence phosphor. Mine is rock- 
steady and flicker-free when connected to a lie. It 
shoios some maufness when connected to a Laser 
129, which I've blamed on that computer. A bad 
cable or had connections can cause giftches, as can a 
cabfc that's too long (It becomes an antenna, picks 
up nitrations from the electromagnetic roar around 
you, and puts them on your screen). 

It is also possible, I suppose, that your picker is 
due to poorly designed CP/M hard- or software, but 
I've neve r heard anyone complain about that before, 
I suspect you need to have your system looked over 
by a technician. 



to blend screen character dots together better than 
the Apple II's circuits do. You can update this circuitry 
on your Apple by adding a stot-3 80-column card 
(this isn't the same thing as an auxifiary slot 80- 
coiumn cardj, such as the ones made by Videx Try 
before you buy, as screen displays arc largely a 
matter of taste. 

By the way, the IBM is not immune from hideous 
flicker, either. Vou'ue been comparing the Apple 
display to IBM's Monochrome Display Adapter output. 
IBM's Color Graphics Adapter is notorious for seuere 
flicker as the screen scrolls— so much so thai! a 
program is being sold by a third party company to 
reduce the irritation 

You might also like to take a close ioofc at the 
following tetter and answer. You don't happen to be 
using an Apple purchased outside the U.S., do you? 

International answers 

Further to Tony Bond's letter ("International Apple- 
Works /I," June 1987, page 3.39) regarding date 
formatting in AppleWorks reports, I would like to 
point out that my program InfoMerge (Pinpoint 
Publishing), which is an AppleWorks report generator 
as well as a mailmerge utility, allows formatting of 
dates (in printed output) in skdifferentways, including 
the European date formats "30 June 1967" and "30- 
6-87". 

And, in answer to the "Hard hardware question" 
about using U.S. monitors in Europe, I know only that 
some years ago, forthe purpose of developing software 
in German, 1 acquired a German lie from Apple 
Computer This contained a U.S. power supply and 1 
used it with a standard U.S. monochrome monitor. 
The only problem I had was in hi-res graphics mode, 
when there was a significant screen flicker, due 
presumably to the frequency difference between the 
Apple motherboard and the video monitor. For the 
purposes of software development 1 found the level of 
flicker to be acceptable, though it might not be so for 
some hi-res video games. 

Peter Meyer 
Captain Cook, Hawaii 

Abdul tladdi in Wichita, Kansas just sent us a copy 
of a tura-page document he got from Apple called 
"International Travel with Apple Computers." This 
sheet saysthat all AppleCPUs, printers, and monitors 
soild in the U.S. (with the single exception of the 
Scribe printer) are designed to work with 110-120 
volts at either 50 or 60 Hertz. Thus any Apple system 
should work anywhere in the world if the voltage is 
properly converted. You wilt need to obtain a step 
down isolation transformer. Do not use a power 
converter designed for hair dryers and electric 
razors. The transformer wiU need to be rated for no 
more than 100 to 150 per cent of the equipment's 
power requirements and shoutd be obtained In the 
country of usage. Since allAppie equipment requires 
a three-prong grounded outlet, the transformer wilt 
need to provide such an outlet." 

However, the "video refresh rate "on an Apple His 
fixed at either SO or GO Hertz, depending on the 
standard in the country of sale. According to the 
document, using a 50 Hertz Apple in a 60 Hertz 
country will cause a flicker in the brighter area of the 
screen withallApple monitors excepltheold Monitor 
III (much as Meyer describes when using a German 
Apple in the U.S.). Using a 60 ffertz Apple in a 50- 
He rtz country, "you may notice asmalt amount of 10 
Hertz weaving or flicker on the screen." 



1 read all this to mean that, except for voltage, 
Apple's monitors and printers are the same all over 
the world. Thus, with the proper transformer, you 
can use monitors or printers purchased in 60 ffertz 
countries in 50 Hertz countries, and uice-uersa, 
freely (Scribe excepted). 

Secondly, except for power supplies and video 
refresh rates (and a few other details, see TrTSC and 
PAL nipples/' December 1986, page 2.87), Apple lis 
are the same all over the world. Thus, with the proper 
transformer (or by changing the power supply, as 
Meyer did— note that some of the power supplies 
listed in "Releasing the power "July 1987, page 3.45, 
are dual 240/120 uoit units) you can use Apple Us 
purchased in GO Herti countries in 50 ffertz countries, 
and yice-uersa, if you are willing tbputup with some 
screen flicker. To avoid the fucker, you must change 
the CPU, not the monitor. 

Thirdly, we still don't know whether a 60 Hertz 
ROB card will work in a 50 Hertz Apple II. Does 
anyone else? 

Another frigid reboot 

In regard to "Reboot, cold reboot, frigid reboot" 
(July 1987, page 3.48): Another way to get a llgs to 
erase and resize the built-in RAMdisk without turning 
the machine off is to hold down both the open-apple 
and option keys and press control-reset The causes 
the machine to start its self test You don't have to wait 
for the self-test to finish, just interrupt it with a 
standard control/open-apple/reset reboot 

James L Liles 
Candor, N.C. 

Very interesting. The self-test must destroy the 
power-up byte that Bill Basham talked about. 

Something old, something new 

Can you have an add-on card in slot 6 on a llgs and 
still use 5.25 inch drives as long as the control panel 
is set up for a disk port? Is there a way to load and run 
DOS 3.3 from the RAM disk? Is there a way to use a 3.5 
inch disk with DOS 3.3? TomCoates 

Hayward, Calif. 

/ haue at this moment a hard disk card in slot 6 of 
my llgs and a 5.25 inch disk on the end of the 
Smartport daisy chain. I can't use them both at the 
same time, hut / can switch bacx and forth by 
entering the control panel, changing the slot 6 
specl/icafion, and pressing open-apple/contml/reset. 

See "DOS 3.5" in our October 1386 issue, page 
2.70, for a nearly complete rundown on how to get 
DOS 3.3 to work on a 3.5 driiK. We can now add a few 
more: DOS 3.3.5 iCali A.P.P.L.E., July 1987, pages 
15-19), andOz-DOS ($39.95 fromHewTech, P. O. Box 
90211 San Diego, CA 92109). Hew Tech also sells 
support software for using the PCP1 Appli-card CP/M 
system with the UniDisk, Profile, and Apple Memory 
Card. 

llgs missing CALL -144 

Your readers might like to know that the Lam 
technique for entering Monitor commands from 
Applesoft programs ("Picking Up Applesoft," February 
1985, page 112; "A charming difference," March 1985, 
page 123; "Lam a'la Ruth," May 1985, page 140; 
"Apple Assembly line," October 1985, page 177; 
"Lam a'la Kashmarek," March 1986, page 216) doesn't 
work on the llgs. The technique's CALL -144 crashes 

thes y stem ' Cecil Frerwell 

Waterloo, Iowa 
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On earlier Apples, CALL -144 ($FF70) jumps into 
OiemiddleofMONZ, the Monitor routine that produces 
the "'"prompt, calls the Monitor's line-input routine, 
and executes the Monitor commands you type in. 
Jumping into the middle of It avoids the call to the 
One-input routine— thus Applesoft can POKE the 
Monitor commands of your choice Into the keyboard 
input buffer and then call on MONZ to execute them. 
However, $FF70 is an "undocumented" entry point 
according to Apple, anyhow - it certainly has been 
welt documented elsewhere. The llgs doesn't support 
this entry point The Laser 128 didn't support it when 
It mas released either, however, it does now Let's 
hope Apple follows Video Technology's lead— not 
supporting this entry point makes a stgni/icanf 
amount of software incompatible with the llgs. 

Forget RAMRD, RAMWRT 

The letter ' Odd bank out" in your April issue (page 
3.22) caught my eye. It seems like Holladay is going 
through an awful lot Just to run a program in anx 
mem. The best rule of thumb on the llgs is to forget 
you ever heard about RAMRD and RAMWRT. You don't 
need them. 

flollada/s program would be better off if itswitched 
to native mode while in main memory, then did a JSL 
to bank $01 After you get to bank $01 you need to 

PrtB saua the old B (data bank) register 
PHK push the l< [program bank] register 
PLB sat B * to ths executing &arik 

da uhateuBr here 

PLB restore B to uhat U UBsd to be 
PJL 

Any code runnl ng in a non-zero bank must execute 
in native mode. This is solely due to interrupts. In 
native mode, the 65816 saves the program bank (R) 
register when an interrupt occurs. In emulation mode 
it does not So when an in terrupt happens in emulation 
mode, the bank information is iost and the only 
possibility is to return to bank 0. This isn't a problem 
for older programs that use emulation mode in aux 
mem, because they use RAMRD and RAMWRT. As 
ftolladay explained, thesE switches turn on the "1" bit 
of the bank address, but the 85816 has no idea that 
anything has happened. As far as Its concerned it's 
sullrunninginbankO. CoreyKosak 

novato, Calif, 

llgs cable sources 

Regarding my previous letter on hooking up the 
llgs to a Sony KVT311CR {"RGB and TV too," March 
1987, page 315): Redmond Cable Corporation, 17371- 
Al RE 67th Ct Redmond, WA 98052, 206 882-2009 
has them for sale at $29 list and $22 if you are a 
developer, etc Theirs are shielded and include the 
voltage divider needed to switch the llgs audio into 
the TV. (Mine isn't shielded, and ] am ordering one of 
theirs.) They can also make them to a specified 
length, up to to 1 5 ft et The not ma! one is 6 feet 

Chris Arndt 
San Luis Obispo, Calif. 

And here's where to get the cable you need to hook 
Disk II drives with the old-style 20 pin header 
connector to the llgs Smartport daisy chain: Applied 
Services, Inc., 7474 Hickory Log Circle, Columbia, 
MD 21045. The cable costs $20 and allows you to 
connect one or two Disk 11 driyes (o the Smartport 
chain. The cable was aduertised in the April 1987 
Call -A.P.P.L.E. classifieds (page 58); a local user 
ordered one and was happy with it 



llgs slots, drives missing 

Two things, First, in the Pebruary 1986 Open- 
Appte, on page 2.8, Jim Luther offers a PFS:Wfite to 
text file converter. The Post Office returned my letter 
as undeliverable. Do you have a later address for 
Luther? 

Second, 1 and one other person in the Princeton 
Apple Users Group have noticed a problem with the 
1 Igs. Occasionally the computer will turn off a slot that 
has been set in the control panel to recognize Tour 
Card". It happens to me for a Disk II controller card, 
and it happens to him with a Sider interface caid. The 
only way either one of us has discovered to restore 
recognition of the card is to power the computer 
down for approximately 8 hours. 

1 realize the details are sketchy at present but 
maybe someone else has discovered a way to avoid 
this problem. At one poinl when this happened to me 
the computer mysteriously cycled through accessing 
the drives and erased part of my Quicken program 
disk and the data disk. Thank God for backups! 

Dan'd Ciotrj 
Trenton, h'.J, 

Luther's address is now 5717 Locust, Kansas City, 
MO 64151 

I haven't seen this one before, but 1 have had my 
Apple 3. 5 drive mysteriously "disappear" a couple of 
times. ProDOS insisted there was no DEVICE COtt- 
NECTED to slot 5, even though the 5.25 disk at the 
end of the Smartport chain was stilt recognized. At 
the time I didn '( JmouJhoiv to do a frigid reboot, and a 
cold reboot wouldn't bring it back, so the only way I 
figured out to "recover" the drive was to turn the llgs 
off. 

Missing printer found 

You have given me the final bits of an AppleWorks 
and Apple llgs puzzle. Mow that I have the whole 
picture, I can give you the rest of it. The missing bit, 
found in your April issue (in the response to "Apple- 
Works phone dialer,'' page 3.19), was the fact that 
AppleWorks can't simultaneously recognize a disk 
and a printer in slot 2, The beginning of the puzzle 
was tlie fact that Applesoft could use my letter quality 
printer in slot 2, but AppleWorks could not 

The rest of the puzzler was the fact that ProDOS 
automatically reassigns a second 3.5 inch disk drive 
to slot 2, drive 1 if you have used the llgs control panel 
to set up a RAMdisk in internal llgs memory. ProDOS 
puts the RAMdisk in slot 5, drive 2. It leaves the 
primary 35 in slot 5, drive 1 

By going into the control panel and setting ihe 
maximum size of the RAMdisk to OK, turning the 
computer off. and rebooting, I was able to get ProDOS 
to put the second 3.5 inch disk back in slot 5, drive 2 
where It belongs (and where Pascal 13 can find it). And 
now a printer or modem located in slot 2 will work 
perfectly under AppleWorks. Denis Anson 

Hillsboro,0r. 

One additional bit of confusion is that if you use 
the control panel to set up the Internal RAMdisk as 
the startup device (look under "slots," not under 
"JWfdiskl the RAMdisk mill be at slot 5, driue 1 The 
3.5s will be in slot 5, drive 2 and slot 2, drive 1 Hfe 
have been unable to figure out a way to change these 
assignments. To do so you'd have the change the 
Smartport "unit numbers" that the devices respond 
to. If anybody figures out how to do this, please let 
us know. I'd personally rather see the llgs RAMdisk 
always in slot 2 drive I Pascal would work better, 



the RAMdisk could always be booted (you can't boot 
from a device in driue 2, no matter what the sloth and 
things would just be a lot more similar to how they 
are with an auxslot card on a He. As things stand 
now, the llgs internal RAMdisk is often best left at OK 

Cards still gobbling ctrl-l 

My printer's manual says the code for 6 lines per 

inch is "CSC Ctrl-* Ctrl-I" but the results I get are 

weird' - . . , „ 

Dr. John A Hunt 

Honolulu, Hawaii 

Our trusty hook of printer codes shows your 
printer uses "ESC Ctrl- If", where tt equals the line 
feed length (plus one.) in 4Sth's of an inch. Therefore, 
for 6 lines per Inch, the value of li should be 9 (9 
minus 1 equals 8, 8 diuided by 48 gives us a line feed 
length of 1/6 inch), which you correctly translate as 
control-/, Unfortunately, thafparu'eutarcode ujiilget 
eaten by your printer interface card every time. Try 
using this code instead, "CtrU Ctrt-Y ESC Ctrl-' Ctrl-! 
Ctrl-Y Ctrl-/". It momentarily changes the interface 
card command code to Ciri-v, then changes it back 
again. For more about this, see our special November 
1985 printer issue, page 186. Page 3.14 of our March 
1987 issue and all the articles it refers to will tell you 
much more thanyoueueruianted to know about the 
problems people encounter when trying to send 
control codes to printers. 

No negative EXEC 

negative numbers can be READ, but not EXEC'd, 
into an INPUT statement (lumbers that begin with a 
decimal point or a plus sign work fine. 

Michael Wertheim 
Plantation, fla 

yep, me get a SYT1TAX ERROR when we try it with 
HiPilTli. Around here we always WWTfltf. however, 
then convert the string to a number if necessary. 
TM'.C handles this with no problems. 

AppleWorks + Multiscribe 

I've been creating hundreds of pages of mathematical 
texts with AppleWorks, using all possible tricks to 
include the special signs mathematicians are used 
to. However, the main problems remain that those 
signs are incorporated in complex formulas, are not 
visible on the screen, and often don't look as they 
should on paper. 

On the other hand, there is Multiscribe, offering 
many possibilities to solve these problems, but with a 
clumsy cut-and-paste system and with far too little 
speed for long texts. 

A possible solution would be to enter text using 
AppleWorks, then transfer the file to Muftiscribe for 
preview, final corrections, and printing. Consequently, 
I am trying to write a program that would read an 
AppleWorks word processor file, convert the AWP 
control codes to Mufliscrioe codes, and create a 
Multiscribe file. I'd also like to write a Afultiserfbe- 
AppleWorks conversion program to go back to the 
AppleWorks environment where file-merge is an easy 
operation. 

The whole process is not so complicated as it 
sounds except for one problem that I haven't solved 
yet Using the "view files" option of Copy // Plus we can 
see a header on each AWF file with some code and the 
position of the tabs. What is the total length of this 
header and what is the meaning of the various bytes? 

BertHoogewijs 
Lochristi, Belgium 
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AppleWorks word processor files start with a 500 
byte header that contains the following information: 



+080 - t003 Nat used. 

+B04 Not mentioned in documentation, 

*835 - -334 Tab stops. Cither = or |. 

+065 Zoom suiteh. Boolean. 

+BBE - »083 Four bytes not usad. 

+090 SodIhr, uhether page break lines 

are currently showing. 

+091 Minm,,- lt F t margin that shpuld be 

-Added -3 rna margin appearing on the 
screen. This is normally one inch, 
shoun In 10ths of an inch, or 10 (J0A). 

+092 Boolean, uhether file contains any 



mail-merge commands. 

+093 - +249 Not usEd. Mo-s sr less reserved 
for mail merge feature. 

+250 - +299 fluailable. Will Neuer be used by 
flppleUorks. If you are creating 
flW UP files, you can use thie area 
to keep information that is important 
to your program. 

Values do seem to change for some of the bytes 
marked "unused." We assume these are artifacts. For 
the Boolean fields, the switch is considered "off if 
the byte holds a zero and "on" if non-zero. 

After the header come a number of variable-length 
line records. The first line after the header corresponds 
to screen fine I the next to screen tine 2, and so on. 

The first two bytes of each line indicate how long 
the rest of the line is. The third byte Indicates the 
screen column for the first character of the line. 
Usually thts is zero, but can vary as a result of left 
margin, centering, and indent com mands. If the high 
bit of the fourth byte is set, the line ends with a 
carriage return. The other seven bits give the number 
of bytes of text following this byte. This text can 
include control codes that indicate special AppieHorJcs 
formatting features such as underline, boldface, and 
superscripts. 

In addition to "text" lines, you will also see two- 
byte "carriage return" and "command" tines. A 
"carriage return" line has a $D0 in the second byte of 
the line. Th e first byte indicates the horizontal screen 
position of the carriage return. A "command" line 
has a value greater than $D0 in the second byte, and 
uarious meaningful values in the first byte. 

" Chars per Inch: 12 chars" (S a Sample of hOW a 

command line appears, on the screen, A line with a 
value, (ess than $1)0 in the second byte (only a zero is 
actually posstMej is a text tine. 

We can send a complete description o/Appieltbrfcs 
file formats to subscribers who request them. Or you 
can downloadtheformats fromaBBS IhalAppleWorks 
author Rupert Lissner has set up. The BBS contains 
technicaf information for developers working on 
accessories that run while AppleWorks is actiue. The 
number of the BBS is 702-851-1722. Dennis recently 
signed on and downloaded this directory to ti 
information auailable; 

File 1. BK. Data Baee common 

Definitions used in a.j data base segments, 
Including the location of Files and uork areas 
in memory. 

File 2, 33K, File formats 

AppleWorks File formats on disk. 

File 3, 20K, Main york area 

Definitions used throughout Applet- <s. Hctint = 
common uork areas used by all applications. 
Defines many of the symbuLs referenced in other 
Files, 



File -1, UK. Iluuk^: cucurnen:a:l;^ 

DeflnBB how to use "hooke" huilt into version 2.0 
that allou you to intercept keystrokes and output 
to the screen. 

File 5, 6K, Host documentation 

Documentation of routines in the permanently 
reeidant portion of flppleUorks. Yc :a- „kb 
these routines; at your Dun risk, of course, 
fC a number of the functions that s-h ■mslc to 
any assembly language program. File 6 defines 
uhere the routines are located. 

File G, 2K, Hast entry pointB 

This defines, addresses that can be J5R'd -c '-■ 
psraanent routines. File 5 deecribes the 
uhat tne routines do. 

File ?, 5K, Sub-host documentation 

This describes more routines that are permanently 
resident, (lost pertain to memory management. 
Please note that a patsnt is pending on these 
memory management routines, so you may end up 
paying royalties if they're copied. 

File B, IK, 5uh-host entry points 

This. File deFinas the entry points for sub-host 
routines. 

File 9, 1GK Spreadsheet Common 

Definitions used In all spreadsheet eegments. 
Including location of files and uork areas in 
menory. 

File 10, 10K, Word processor Common. 

Definitions lissd in all uord processor segments, 
including location of filee and uork areas in 
-3"-y. 

Files 11, 12, and 13, 41K, 5EG.PR source code 

File 14, ZK, Memory manager 

Use of Ilgs memory manager by version 2.0. 

File 15, 33K, File formats 

AppleWorks file formats on disk. 

File 16, 2K. Bugs File 

Bugs in 2.0, and conflicts betueen 2.0 and other 
programs being developed for the Ilgs, 

Another use for AppleWorks 

Are you aware that Appleworks comes with a utility 
program that allows you to read and print the data In 
damaged Appleworks database files? You can even 
use this utility to produce an ASCI! text file, which can 
be used in turn to create a new database file. The 
nameof this utility? it's the Word Processor! 

Here's howit works, Select "Add files to the desktop" 
and "Make a new file for the word processor". When 
the program prompts you for the source of the new 
file, choose "from a text (ASCII) file." Unlike most 
other programs, the Appleworks word processor will 
not check to see if the file you name is actually an 
ASCI I text file and will load just about anythingyou tell 
it to, including AppleWorks data base files. 

When you load anAppleWorks data base file you'll 
see all the data that's in it.along with a lot of other 
stuff. In fact, the screen may look so confusing that 
you'll decide to re-enter the data from the keyboard. 
That's fine, but at least you can now produce a hard 
copy of the data to work from. 

Ifyou decide to reformat the data and create a new 
ASCII file to load into the data base, the task will go 
faster with a word processor that can search and 
replace with control characters, such as FreeWriter or 
Apple Writer. If you choose this option, it may take 
some time to format the data correctly, but you are 
rewarded bynot having teletype or proofread anything. 

The technique also works with files from other 
programs. DOS 3.3 database files require conversion 



to FroDOS first, but otherwise all the operations are 
basically the same. If your database file contains 
mostly text, you'll find the task a relatively simple one. 
Mostly numeric data may require a hard copy as an 
aid in locating the numerals amidst all the the other 
stuff Steve Qoldstine 

KEO Apple Corps 
Cleveland, Ohio 

Now there's a neat trick. Interestingly, Apple 
Writer wiU. also directly toad any type, of file, but it 
stops loading as soon as it encounters a zero byte. In 
AppleWorks data base files, thts occurs long before 
you get to the part of the file that holds data. 

In addition to fixing damaged data base files, this 
technique could be very useful for converting random- 
access text files from older programs into AppleWorks 
data base files. If the random-access file is on a DOS 
3.3 diss, use Copy II Phis to convert it to a FroDOS 
disk first 

Our March 1987 article, "Reading AppleWorks data 

on the word processor screen into what must have, 
been in the data base pie. It uiould probably also be 
helpful to take a file bacfc to the AppleWorks word 
processor for final formatting. The easiest way to 
figure out if you have the correct number of return 
characters In each record is to simply load the file 
into the data base and took to see if everything is 
appearing in the correct category. At the spot where 
the relationship between data and categories gets 
messed up you are either missing a return or you 
haue an extra one. Qfuick change) back to the word 
processor, fix that spot, and try again. 

Subscriber James Green in HbodJand Hilts, Califor- 
nia also urote us about this trick, but he uses it to 
recover damaged word processor files. 

More uses lor our ADB reader 

Thank you very much for your reply to my recent 
request for help in recovering a damaged AppleWorks 
database Unfortunately, after spending hours studying 
the file, I could not find anything wrong with it 
according to the published file layout It still would 
not load into AppleWorks. 

At that point I took another tack which your readers 
might find helpful. Using your AppleWorks Database 
Reader program {March 1987, pages 3.9-312) as a 
starting point, 1 wrote a program that read my file and 
wrote it into a text file, which I then used to create a 
new AppleWorks database Through this method I 
was able to salvage all three years of the "lost" 
magazine index with only about 30 minutes of work, 
versus many, many hours of re-entering the data. 

R. W Crowley 
Manchester Mo. 

Here's another application for our ADB.READER. 
Dennis recently saw an ad for an MS-DOS program 
that "compiles" Lotus 1-2-5 data files into free- 
standing applications that do not require Lotus itself 
to use. In other words, a "developer" can use Lotus 
to enter and manipulate specialized data, "compile" 
thedata info a free standing application, ftaiseiit/ie 
data to customers who don't have Lotus. Our 
ADB.READER is only a step or two away from the 
same thing for AppleWorks. A database format could 
be laid outwith AppleWorks, thefile data entered and 
edited into usable form, then the final database 
distributed with an enhanced version of our "reader" 
program. Thus a ' simple" Applesoft program could 
tumAppleWorks into a database development system 
o/ sorts. 
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A new horror story 

Rease warn users about Applied Engineering's HD- 
55A disk drives. When using these drives to make 
copies, one or more sectors on the source disk are 
usually trashed and can not be verified. Putting on a 
write tab does no good. With COPYAyou may seem to 
have a good copy but, if you by to repeat the copy from 
the same source disk, you will get read errors. 

John Waters 
Baltimore, fW. 

The word from Applied Engineering Is thai one 
group o/ their drives had this problem and they 
issued a recall. The drives were bad right out of the 
box. It may seem a little paranoid, but perhaps the 
lesson here is that alt new equipment should be 
carefully checked with dummy files and data before 
using it with the real thing. 




I would like to know whether there is any spreadsheet 
program that lets one use the IF statement with text 
For example, I would like to use a statement such as 
lFlA5="Sam",0.1 ). Neither AppleWorks nor Multiplan 
allow text as a clause or argument in formulas; is 
there any other spreadsheet program that has this 
facility? 

DrS.S.Datye 
Akureyri, Iceland 
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Mow do you get AppleWorks Lo report an alphabetic 
response in a lookup table? 

Carl J.Morrison 
Anaheim, Calif. 

SuperCalc 3a soloes both problems. It allows text 
to be assigned as a yalue by enclosing the text in 
parentheses and quotes, as in I'Thisisa text value 'I. 
for example, if you set celt A3 to l Fred"), and celt 
AlQtoir(A5=CSam"),LA5h thenceUAlOwilldisptay 
the word "Fred", 

SELECT stops expandedWorks 

Regarding Michael CoMlle's "hanging on startup" 
problem with AppleWorks 2,0, as expanded with 
Applied Engineering's software (July 1987, page 3.44): 
quite by accident (after much cursing and swearing, 
which had no effect at aft) I discovered that this 
problem occurs only when I l»ot or restart AppleViforks 
with my I mage Writer on and the printer "select" 
switch off, 

Either tumi nq on the select switch or turning off the 
printer will allow the boot process to continue after it 
has halted on the "Getting Started" screen, 

Steve Moore 
Carpinteria, Calif. 

7ftanJcs also go fo flobert Urschel and Quentm 
Packard, who made the same discovery. An unex- 
panded copy of AppleWorks 2.0doesn't hang on my 
Ilgs In this situation, so I suspect AE's expansion 
software is trying to send some kind of initlaiization 
string to the printer. 

You could discouer more by turning your printer 
on in "hex dump'' mode and seeing what gets 
printed when you startup AppleWorks. With the 
ImageWriter I, you do this by turning the printer on 
while holding down on Ine "form feed" button; with 
the ImageWriter II, use ihe "select" button. 

Pushing back the limits 

I may be able to shed some light on the AppleWorks 
"150 file maximum" and "memory card hogging" 
problems mentioned in your July issue (page 3.45). 

First the subdirectory limitation .. .my guess Ls that 
the number of files that appears in the screen 
message (130) was originally set by approximation 
and has never been updated. 1 checked ail of the 
versions I have access to and found that 10, H 12, 
and 13 all allocate $1000 bytes of buffer space for 
filenames from a subdirectory. Version 2.0, however, 
allocates only $800 bytes. The buffer is used to sort 
the names Into alphabetical order. Each name entry 
(as used here) has $18 bytes, This means that the 
older versions ol AppleWorks will actually show 170 
names and the newer ones will show85. Interestingly, 
what triggers the screen message is a buffer overflow 
...try cataloging a subdirectory with 169 names in 
version 13. It will show all of them without the '130 
file maximum" message. 

As for the memory card rtogging problem, after 
studying the "SY5.DESKTOP" expansion function that 
AppleWorks 13 and newer uses with the Apple 
Memory Expansion Card and compatibles, 1 came up 
with this little patch program. In theory you only need, 
to execute it once; however, in reality you will probably 
run it several times until you figure out your personal 
"ideal" desktop size. Itwill patch AppleWorks versions 
13 and 2.0 (with minimum verification). To keep the 
program simple, the user gets to set the prefix to the 
volume (or subdirectory) where APUfVORKS.SYSTEM 



lives before running the program — the user also gets 
to handle any errors that come along, 

The progra m wi 11 al low you to set your desktop from 
56K up to about 1020K. If you make it too big, you are 
deleatino, the purpose [leaving room on the RAMdisk 
for other files). If you make it too small, Appletlforks 
will act as if the card already has too many files and it 
won't expand into the memory card - this will cause 
you to miss out on the other goodies that come with 
expansion, 

10 REM Desktop Slier for Sllnky-typs cards 
20 REM by Staus 5;«pnsnsrjn 
30 : 

40 D*>QW>(4) : PRINT DJi"PBB3~ : HDME 

50 PRINT "What K size desktop do you uant? *j 

ss input --;i« 

d0 K-VflL(Kt) : K=K»2 * IS 

ES KHI=INT(K/25EJ : KLD-K - KHI*2SB 

f» PR[«iT DSfBLOAD flPLWQRK5, SYSTEM, ftf200B,TJFF- 

88 IF PEEK[ 8152*3) =20 THEN 200 : REM skip to «2.8 

:w rem fix ,;.3 

118 FIX=94aa*489S : UEDGE=92B2«4896 

128 FDR I = 8 TO 25 

138 REM) J : POKE FIX+I.J : NEXT 

148 DATA 170,173.223.34, 201, 0,173,224, 34,233,8,176. 

2,138,96,169.8. 141,223.34. 155.8,141,224, 34,96 

lSe EDTO 388: OEM goto comon fix 

200 REM fix w2.8 

218 FIX*9429*4896 : UEDCE=9662*4096 

228 FOR 1=0 TO 25 : READ J : NEXT : REM other data 

238 FOR 1-0 TO 25 

2AH WERD J : POKE FIXtl.J : NEXT 

7=0 DATA 170,173,62.35,201,0,173,63.35,233.8.176. 
2,13H,9E,1S9, 0,141,52,35,169, 0,141.63,35,96 

300 REM common Fix routlna 
310 PDKE FIX+5.KLD : POKE FIX+18.KH1 
320 PDKE FIX+16.KL0 : POKE FIX+21.KH1 
330 PDKE WEDGE, 32 

340 POKE HEDGE+2, INT l(FlX-489S|/256) 

350 POKE WEDEE*l,[FIX-4896) - (PEEK(tfTJGE+2)«25GJ 

360 PRINT D$:"UNLDCK RPLUDOKG.S^'STEM ' 

370 PRINT DS;-B5fWE HPLUDWkf J .5 I rSTEM,flI2000,TIFF- 

3B8 PRINT : PRINT TJane." : END 

Steve Stephenson 
Synesis Systems 
P.O. Box 1308 
Gilbert AZ 85234 

My personal AppleWorks disk doesn't have the 85 
or so limit on AppleWorks files in a subdirectory. 
Maybe it's because of this patch: 

PDKE 753,40 
PDKE 759,29 

BSRYE 5EG.Ml,T8.L2,M388,Bll'tZafl 

The patch increases the slie of the Appleltorks 2.0 
catalog buffer so that it will hold 130 filenames. The 
area beyond the catalog buffer is unused when file 
handling activities are going on. 

Randy Brandt 
JEM Software 
P.O. Box 20920 
EICajon,CA 92021 

Stephenson's patch is for //-Plus, He, and lie 
AppleWorks users with an Apple Memory Expansion 
Card or the equivalent (Ramfactor, ptusRAN). The 
patch has no effect on Apple ttbrfcs if you use a Ilgs 
because on thai machine AppleWorks refuses to look 
for a standarti-sfot-based memory card. (Incidentally, 
for those of you who don't recognize their names, 
Stephenson is the author of Checkmate Technology's 
AppfeHtorfcs expansion software and Brandt is the 
author of Beagle Bros' MacroHbrfcs and Super 
MacroWorks.i 



